home *** CD-ROM | disk | FTP | other *** search
/ CD School House 9 / CD School House 9.0 - Wayzata Technology (1994).iso / mac / Win / TEACHAID / LECT100 / LECTURE.DOC < prev    next >
Text File  |  1994-03-20  |  66KB  |  1,702 lines
  1.  
  2.                                           i
  3.  
  4.  
  5.  
  6.  
  7.  
  8.                                     Contents
  9.  
  10.  
  11.                Legal notices                                          1
  12.                   Program warranty . . . . . . . . . . . . . . . . .  2
  13.                   U.S. Government restricted rights  . . . . . . . .  2
  14.  
  15.                Evaluation copies                                      3
  16.                   Disk vendors . . . . . . . . . . . . . . . . . . .  3
  17.                   Bulletin board operators (sysops)  . . . . . . . .  3
  18.                   Colleges & teachers  . . . . . . . . . . . . . . .  3
  19.  
  20.                Registering Lecture                                    4
  21.                   Volume discounts . . . . . . . . . . . . . . . . .  4
  22.                   Site licenses  . . . . . . . . . . . . . . . . . .  4
  23.                   Reseller discounts . . . . . . . . . . . . . . . .  5
  24.  
  25.  
  26.                Part 1:  Getting started
  27.  
  28.  
  29.                Chapter 1:  What is Lecture?                           7
  30.  
  31.                Chapter 2:  Installation                               8
  32.                   2.1  Requirements  . . . . . . . . . . . . . . . .  8
  33.                   2.2  Setting up Lecture  . . . . . . . . . . . . .  8
  34.                   2.3  Command line summary  . . . . . . . . . . . .  8
  35.  
  36.  
  37.                Part 2:  Using Lecture
  38.  
  39.  
  40.                Chapter 3:  Presenting a lecture                      10
  41.                   3.1  Start a presentation  . . . . . . . . . . . . 10
  42.                   3.2  Flip slides . . . . . . . . . . . . . . . . . 10
  43.                   3.3  Automated lectures  . . . . . . . . . . . . . 10
  44.                   3.4  Lecture messages  . . . . . . . . . . . . . . 11
  45.                   3.5  Lecture noises  . . . . . . . . . . . . . . . 11
  46.                   3.6  Repeat a lecture  . . . . . . . . . . . . . . 11
  47.                   3.7  Save window settings  . . . . . . . . . . . . 11
  48.                   3.8  Terminate Lecture . . . . . . . . . . . . . . 11
  49.  
  50.                Chapter 4:  Developing a lecture                      12
  51.                   4.1  Advanced concepts . . . . . . . . . . . . . . 12
  52.                      4.1.1  Title screen . . . . . . . . . . . . . . 12
  53.                      4.1.2  Initialization file  . . . . . . . . . . 12
  54.  
  55.                Chapter 5:  Lecture file commands                     13
  56.                   5.1  Comments  . . . . . . . . . . . . . . . . . . 13
  57.                   5.2  Command lines . . . . . . . . . . . . . . . . 13
  58.                   5.3  Command syntax  . . . . . . . . . . . . . . . 13
  59.                      5.3.1  ACCEPT . . . . . . . . . . . . . . . . . 13
  60.  
  61.                                          ii
  62.  
  63.  
  64.  
  65.                      5.3.2  AUTOSHOW . . . . . . . . . . . . . . . . 14
  66.                      5.3.3  BEEP . . . . . . . . . . . . . . . . . . 14
  67.                      5.3.4  COLORBACKGROUND  . . . . . . . . . . . . 15
  68.                      5.3.5  COLORMASTERTITLE . . . . . . . . . . . . 15
  69.                      5.3.6  COLORPOINT . . . . . . . . . . . . . . . 16
  70.                      5.3.7  COLORSUBTITLE  . . . . . . . . . . . . . 17
  71.                      5.3.8  COLORTITLE . . . . . . . . . . . . . . . 17
  72.                      5.3.9  COMMENT  . . . . . . . . . . . . . . . . 18
  73.                      5.3.10  FONTMASTERTITLE . . . . . . . . . . . . 18
  74.                      5.3.11  FONTPOINT . . . . . . . . . . . . . . . 19
  75.                      5.3.12  FONTSUBTITLE  . . . . . . . . . . . . . 19
  76.                      5.3.13  FONTTITLE . . . . . . . . . . . . . . . 20
  77.                      5.3.14  ICONIZE . . . . . . . . . . . . . . . . 20
  78.                      5.3.15  IGNORE  . . . . . . . . . . . . . . . . 20
  79.                      5.3.16  MASTERTITLE . . . . . . . . . . . . . . 21
  80.                      5.3.17  MESSAGE . . . . . . . . . . . . . . . . 21
  81.                      5.3.18  MESSAGETITLE  . . . . . . . . . . . . . 21
  82.                      5.3.19  MINVERSION  . . . . . . . . . . . . . . 22
  83.                      5.3.20  POINT . . . . . . . . . . . . . . . . . 22
  84.                      5.3.21  RUNFILE . . . . . . . . . . . . . . . . 23
  85.                      5.3.22  SAMEPOINT . . . . . . . . . . . . . . . 23
  86.                      5.3.23  SHOW  . . . . . . . . . . . . . . . . . 24
  87.                      5.3.24  SHOWANDSAVE . . . . . . . . . . . . . . 24
  88.                      5.3.25  SUBPOINT  . . . . . . . . . . . . . . . 24
  89.                      5.3.26  SUBSUBPOINT . . . . . . . . . . . . . . 25
  90.                      5.3.27  SUBSUBSUBPOINT  . . . . . . . . . . . . 25
  91.                      5.3.28  SUBTITLE  . . . . . . . . . . . . . . . 25
  92.                      5.3.29  TITLE . . . . . . . . . . . . . . . . . 26
  93.                      5.3.30  TOTALPOINTS . . . . . . . . . . . . . . 26
  94.                      5.3.31  UNCOMMENT . . . . . . . . . . . . . . . 27
  95.                      5.3.32  UNICONIZE . . . . . . . . . . . . . . . 27
  96.                      5.3.33  UNZOOM  . . . . . . . . . . . . . . . . 28
  97.                      5.3.34  WAIT  . . . . . . . . . . . . . . . . . 28
  98.                      5.3.35  ZOOM  . . . . . . . . . . . . . . . . . 28
  99.  
  100.  
  101.                Part 3:  Appendixes
  102.  
  103.  
  104.                Appendix A:  Status & error messages                  30
  105.  
  106.                Appendix B:  Helpful hints                            32
  107.                   B.1  Invoking Lecture  . . . . . . . . . . . . . . 32
  108.                   B.2  Common questions & answers  . . . . . . . . . 32
  109.  
  110.                Appendix C:  Troubleshooting a lecture file           33
  111.  
  112.                Index                                                 34
  113.  
  114.  
  115.                                      Tables
  116.  
  117.                Table 2.1: Mandatory Lecture files  . . . . . . . . .  8
  118.                Table 2.2: Optional Lecture files . . . . . . . . . .  8
  119.  
  120.                                          iii
  121.  
  122.  
  123.  
  124.                Table 3.1: Lecture shortcut commands  . . . . . . . . 10
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.                                     Legal notices
  136.  
  137.                                  LECTURE Version 1.0
  138.  
  139.  
  140.                                   Barn Owl Software
  141.                            P.O. Box 74, O'Fallon, IL 62269
  142.  
  143.  
  144.                Voice
  145.                line      (618) 632-7345, regular business hours
  146.  
  147.                Orders
  148.                only      (800) 788-0787
  149.  
  150.                Fax line  (618) 632-2339
  151.  
  152.                Compu-
  153.                Serve     74017,1344
  154.  
  155.                InterNet  74017.1344@compuserve.com
  156.  
  157.                Telex     3762848.  First line must say
  158.                          "TO:EASYPLEX:74017,1344"
  159.  
  160.           Lecture software & documentation Copyright 1992 by Barn Owl
  161.           Software; all rights reserved worldwide.  Any specific hardware/
  162.           software names used in this manual are the (registered) trade-
  163.           marks of specific companies.  Barn Owl Software is a member of
  164.           the Association of Shareware Professionals and Lecture falls
  165.           under ASP guidelines for shareware products.
  166.  
  167.           You may not modify Lecture in any way that changes the program's
  168.           actual computer instructions unless these methods are approved by
  169.           Barn Owl Software.
  170.  
  171.           Barn Owl Software strives to produce technically accurate docu-
  172.           mentation for its products but we're only human.  This manual may
  173.           contain any number of typographical, graphical, printing, or
  174.           interpretation errors.
  175.  
  176.           2                                        Lecture v1.0 User Manual
  177.  
  178.  
  179.  
  180.                This program is produced by a member of the Association
  181.                of Shareware Professionals (ASP).  ASP wants to make
  182.                sure that the shareware principle works for you.  If you
  183.                are unable to resolve a shareware-related problem with
  184.                an ASP member by contacting the member directly, ASP may
  185.                be able to help.  The ASP Ombudsman can help you resolve
  186.                a dispute or problem with an ASP member, but does not
  187.                provide technical support for members' products.  Please
  188.                write to the ASP Ombudsman at 545 Grover Road, Muskegon,
  189.                MI 49442 or send a Compuserve message via easyplex to
  190.                ASP Ombudsman 70007,3536.
  191.  
  192.  
  193.           Program warranty
  194.  
  195.           Lecture is offered under the shareware concept: users may
  196.           thoroughly test the program before paying for it.  Because of the
  197.           diversity of conditions, hardware, and other software under which
  198.           the program may be used, no warranty of fitness for a particular
  199.           purpose can be offered.
  200.  
  201.           Barn Owl Software offers a 30-day money back guarantee after
  202.           purchase, no questions asked.  You may return all materials for a
  203.           full refund during this time.  Materials must be in good
  204.           condition.  This applies only to copies sold directly by Barn Owl
  205.           Software or purchased through direct resellers (such as Public
  206.           software Library).  WE DO NOT REFUND PRODUCTS SOLD BY INDIRECT
  207.           RESELLERS.
  208.  
  209.           Physical materials (manuals, disks, etc.) supplied by Barn Owl
  210.           Software are warranted to be free of defects in workmanship for
  211.           the life of the product.  Users may return defective materials
  212.           anytime for replacement at no charge.
  213.  
  214.           ANY IMPLIED WARRANTIES, INCLUDING THOSE OF MERCHANTABILITY OR
  215.           FITNESS FOR A PARTICULAR PURPOSE, ARE LIMITED TO THE TERMS OF THE
  216.           EXPRESS WARRANTIES.  IN NO CASE SHALL LIABILITY EXCEED THE
  217.           MONETARY FEES PAID FOR THE RIGHT TO LEGALLY USE THE PRODUCT.
  218.  
  219.  
  220.           U.S. Government restricted rights
  221.  
  222.           Use, duplication, or disclosure by the government is subject to
  223.           restrictions as set forth in Rights in Technical Data and Com-
  224.           puter Software, para (c)(1)(ii), DFARS 242.227-7013 (10/88) and
  225.           FAR 42.227-19 (6/87).  Contractor is Barn Owl Software, P.O. Box
  226.           74, O'Fallon, IL 62269.
  227.  
  228.           Evaluation copies                                               3
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.                                   Evaluation copies
  237.  
  238.           You may try Lecture on a 30-day trial basis to determine if this
  239.           program meets your needs.  You must then either purchase your
  240.           copy/copies of the program or quit using it.
  241.  
  242.           You may give UNMODIFIED copies of Lecture to others so they can
  243.           evaluate it for their needs, subject to the same restrictions and
  244.           conditions above.
  245.  
  246.  
  247.           Disk vendors
  248.  
  249.           The Association of Shareware Professionals sets standards for
  250.           disk vendors if they wish to obtain ASP approved status.  You can
  251.           learn more by writing to the ASP vendor membership committee, 545
  252.           Grover Road, Muskegon, MI 49442.
  253.  
  254.           Barn Owl Software, like many ASP members, lets ASP approved disk
  255.           vendors distribute Lecture without having to ask first.  We send
  256.           master disks to ASP approved disk vendors at no charge.
  257.  
  258.           If you are not an ASP approved disk vendor, please send a copy of
  259.           your catalog with your request to distribute our product.
  260.  
  261.  
  262.           Bulletin board operators (sysops)
  263.  
  264.           Bulletin board operators (sysops) may offer unmodified copies of
  265.           Lecture on BBSs and other electronic information services so
  266.           others can download the program and evaluate it for their needs.
  267.  
  268.  
  269.           Colleges & teachers
  270.  
  271.           Barn Owl Software is happy to help teachers offering courses on
  272.           Lecture.  We can supply master disks & manuals as course
  273.           materials.  Please contact us for more details.  You'll find our
  274.           address & phone numbers on page 1.
  275.  
  276.           4                                        Lecture v1.0 User Manual
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.                                  Registering Lecture
  285.  
  286.           Please submit a completed registration form with proper payment
  287.           to continue using Lecture after your 30-day trial period.  Look
  288.           for the REGISTER.FRM file on your master disk.
  289.  
  290.           Your Lecture registration includes the following:
  291.  
  292.              * One year of voice support at (618) 632-7345, fax support at
  293.                (618) 632-2239, and newsletter support;
  294.              * The latest version of Lecture is sent on disk and you will
  295.                be notified for at least a year when major enhancements are
  296.                made to the program;
  297.              * Information on how to get a CompuServe IntroPak that waives
  298.                the normal sign-up fee and gives you a $15 usage credit on
  299.                top of it.
  300.  
  301.  
  302.           Volume discounts
  303.  
  304.           The following discounts apply for regular orders.  Each package
  305.           consists of a set of disks, a professionally printed manual, and
  306.           the registration benefits shown above.  This is a per order
  307.           discount, not an accumulative order discount.
  308.  
  309.              001 - 002 packages   00% discount
  310.              003 - 009 packages   05% discount
  311.              010 - 019 packages   10% discount
  312.              020 - 049 packages   20% discount
  313.              050 - 099 packages   30% discount
  314.              100 - XXX packages   ask for details
  315.  
  316.           Barn Owl Software accepts purchase orders (POs) only from
  317.           schools, government agencies, and Fortune 1000 companies.  Please
  318.           add a $10 processing fee on POs less than $100.
  319.  
  320.  
  321.           Site licenses
  322.  
  323.           Barn Owl Software offers site licenses if you don't need manuals
  324.           and technical support for each copy of the program you use.  We
  325.           supply you with one gold disk & manual and give you a license so
  326.           up to XX people in your organization can legally use the program.
  327.  
  328.           See the SITELIC.DOC file included with Lecture for more details.
  329.  
  330.           Registering Lecture                                             5
  331.  
  332.  
  333.  
  334.           Reseller discounts
  335.  
  336.           Please contact Barn Owl Software if you resell software or
  337.           hardware and wish to offer Lecture to your customers.
  338.  
  339.           We also offer an attractive runtime license for companies wishing
  340.           to include lecture files with their products.  Contact Barn Owl
  341.           Software for details.
  342.  
  343.           6                                        Lecture v1.0 User Manual
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.                                         PART 1
  364.                                    Getting started
  365.  
  366.           Chapter 1, `What is Lecture?'                                   7
  367.  
  368.  
  369.  
  370.  
  371.  
  372.                                       Chapter 1
  373.                                   What is Lecture?
  374.  
  375.           Lecture, quite simply, gives you the power to present a text-
  376.           based slide show lecture in the Windows environment.
  377.  
  378.           Similar "presentation packages" (notably Microsoft's PowerPoint)
  379.           focus primarily on the graphics aspect of a slide show.
  380.           Graphics-based slide show packages look pretty and they certainly
  381.           appeal to people who have the time to create a snazzy
  382.           presentation.  But these programs overwhelm many potential users
  383.           with power, complexity, graphics orientation, and often a high
  384.           price tag.
  385.  
  386.           College professors, business professionals, local/state
  387.           politicians, and many others need a program to deliver text-only
  388.           presentations on a moment's notice.  Lecture solves this need.
  389.  
  390.           You create lectures with Microsoft's NotePad or any other text
  391.           editor, then tell Lecture to display it on the screen in a
  392.           traditional window.  The program has numerous commands to augment
  393.           a presentation, but the core of every lecture rests on just six
  394.           commands: MasterTitle, Title, SubTitle, Point, SubPoint, and
  395.           Show.  You can learn how to use these commands and write your
  396.           first slide show lecture in just a few minutes.
  397.  
  398.           Like any good slide show program, Lecture lets you flip slides
  399.           with the click of a mouse button.  Lecturers don't have to move
  400.           from the podium to a keyboard -- they can hold the mouse in one
  401.           hand while delivering a speech.
  402.  
  403.           Lecture comes out of the box with several example lecture files,
  404.           including (of course) one describing Lecture itself.  Feel free
  405.           to study the samples to learn how to write your own lectures.
  406.  
  407.           8                                        Lecture v1.0 User Manual
  408.  
  409.  
  410.  
  411.  
  412.  
  413.                                       Chapter 2
  414.                                     Installation
  415.  
  416.  
  417.           2.1  Requirements
  418.  
  419.           Lecture requires an IBM AT, PS/2, or compatible computer with
  420.           Windows 3.0 or better running in standard or 386enh mode.  The
  421.           program does not need scalable fonts (available via third-party
  422.           font packages and included with Windows 3.1) but users of such
  423.           fonts will find this program more aesthetically appealing.
  424.  
  425.           The following tables describe the necessary and optional files
  426.           which make up Lecture:
  427.  
  428.                          Table 2.1: Mandatory Lecture files
  429.           -----------------------------------------------------------------
  430.              LECTURE.EXE   The actual program
  431.           -----------------------------------------------------------------
  432.  
  433.  
  434.                           Table 2.2: Optional Lecture files
  435.           -----------------------------------------------------------------
  436.              LECTURE.LEC   Sample lecture file.  Demonstrates all the
  437.                            capabilities of the program.
  438.              READ.ME!      Contains late-breaking Lecture notes
  439.              *.LEC         Various sample lecture files.  Shows how easily
  440.                            you can create a slide show lecture of your own.
  441.           -----------------------------------------------------------------
  442.  
  443.  
  444.           2.2  Setting up Lecture
  445.  
  446.           Lecture is easy to install: copy all the files to a directory of
  447.           your choice and use the Windows `File/New' menu option to create
  448.           an icon for it in Program Manager.  (Consult your Windows manual
  449.           or call Barn Owl Software if you need help.)  Start the program
  450.           by double-clicking the program's icon.
  451.  
  452.  
  453.           2.3  Command line summary
  454.  
  455.                                 LECTURE  [lecturefile]
  456.  
  457.           Lecture begins when you choose "File/Run" from Windows and enter
  458.           "LECTURE" or when you double-click on the program's icon.  You
  459.           may also specify an optional lecture filename to run immediately.
  460.  
  461.                                                                           9
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472.  
  473.  
  474.  
  475.  
  476.  
  477.  
  478.  
  479.  
  480.  
  481.                                         PART 2
  482.                                     Using Lecture
  483.  
  484.           10                                       Lecture v1.0 User Manual
  485.  
  486.  
  487.  
  488.  
  489.  
  490.                                       Chapter 3
  491.                                 Presenting a lecture
  492.  
  493.                         Table 3.1: Lecture shortcut commands
  494.           -----------------------------------------------------------------
  495.  
  496.              Ctrl+R      run a lecture file
  497.  
  498.              Spacebar
  499.              RMouseButton
  500.              Enter
  501.              PgDn
  502.              Ctrl+N      show next slide
  503.  
  504.              Backspace   show previous slide
  505.  
  506.              Alt+F4      close window, end program
  507.  
  508.           -----------------------------------------------------------------
  509.  
  510.  
  511.           3.1  Start a presentation
  512.  
  513.           Choose the "File/Run" menu item or press Ctrl+R to process a
  514.           lecture file.  The file must already exist.  Lecture will
  515.           immediately interpret commands in the file.
  516.  
  517.  
  518.           3.2  Flip slides
  519.  
  520.           Choose the "File/Next slide" menu item to present another slide
  521.           in a lecture file.  Or press the right mouse button, or press the
  522.           Spacebar, or press Enter, or press PgDn, or press Ctrl+N -- they
  523.           all do the same thing.
  524.  
  525.           Choose the "File/Prev slide" menu item to present the previous
  526.           slide in a lecture file.  Or press the Backspace key -- it does
  527.           the same thing.
  528.  
  529.  
  530.           3.3  Automated lectures
  531.  
  532.           Some lecture files include one or more AutoShow commands so the
  533.           presentation runs in automatic mode.  You can tell the program
  534.           whether to accept any such command with the "Options/AutoShow
  535.           allowed" menu item.  (A checkmark appears next to the menu item
  536.           when activated.  Choose the menu item again to deactivate it.)
  537.  
  538.           Chapter 3, `Presenting a lecture'                              11
  539.  
  540.  
  541.  
  542.           3.4  Lecture messages
  543.  
  544.           Some lecture files augment their presentation with one or more
  545.           Message commands.  You can tell the program whether to accept any
  546.           such command with the "Options/Messages allowed" menu item.  (A
  547.           checkmark appears next to the menu item when activated.  Choose
  548.           the menu item again to deactivate it.)  Note: you cannot turn off
  549.           syntax error messages via this menu item.
  550.  
  551.  
  552.           3.5  Lecture noises
  553.  
  554.           Some lecture files generate noises as a way to augment their
  555.           presentation.  You can tell the program to accept any such
  556.           command with the "Options/Noises allowed" menu item.  (A
  557.           checkmark appears next to the menu item when activated.  Choose
  558.           the menu item again to deactivate it.)
  559.  
  560.  
  561.           3.6  Repeat a lecture
  562.  
  563.           Select the "Options/Repeat when done" menu item to automatically
  564.           repeat the current lecture file at the end.  (A checkmark appears
  565.           next to the menu item when activated.  Choose the menu item again
  566.           to deactivate it.)  Lecture will wait ten seconds and then
  567.           process the file again.  This loop continues until you deactivate
  568.           the option or terminate the program.
  569.  
  570.  
  571.           3.7  Save window settings
  572.  
  573.           Choose the "Options/Save window settings" menu item to let
  574.           Lecture automatically save the current state of its window to a
  575.           configuration file.  (A checkmark appears next to the menu item
  576.           when activated.  Select the menu item again to deactivate it.)
  577.           When you start the program next time, it will appear in the same
  578.           place on the screen with the same window dimensions.
  579.  
  580.  
  581.           3.8  Terminate Lecture
  582.  
  583.           Choose the "File/Exit" menu item or press Alt+F4 to close the
  584.           Lecture window and terminate the program.
  585.  
  586.           12                                       Lecture v1.0 User Manual
  587.  
  588.  
  589.  
  590.  
  591.  
  592.                                       Chapter 4
  593.                                 Developing a lecture
  594.  
  595.           A good lecture flows smoothly from one slide to the next.
  596.           Presentations normally start with a title slide and follow with
  597.           an abstract of what you hope to cover.  The end of the lecture
  598.           usually wraps up with a summary of what you covered, followed
  599.           perhaps by a "The End/Thank you" slide.
  600.  
  601.           A slide generally should list no more than seven points/
  602.           subpoints, and Lecture defaults to this value at startup.  You
  603.           can change the maximum number of points allowed on a slide either
  604.           with the TotalPoints command (chapter 5) or by changing the
  605.           LECTURE.INI file (chapter 4.1.2).
  606.  
  607.  
  608.           4.1  Advanced concepts
  609.  
  610.           4.1.1  Title screen
  611.  
  612.           You can create the equivalent of a title slide by temporarily
  613.           overriding the default TotalPoints value with a smaller number
  614.           (perhaps a value of 2 or 3).  Lecture uses this value to
  615.           calculate the size of text so it fits within the visible window.
  616.           Study the LECTURE.LEC file if you need more details on how to
  617.           implement this technique.
  618.  
  619.           4.1.2  Initialization file
  620.  
  621.           You can modify the way Lecture works by adding certain items to
  622.           its LECTURE.INI configuration file.  (Consult your Windows manual
  623.           if you need more details about how such files work.)  The
  624.           following items must appear under the "[Lecture]" heading:
  625.  
  626.           RepeatDelay=10
  627.              Tells Lecture how many seconds to wait before it repeats a
  628.           lecture file.  Defaults to 10 seconds.  You can specify a value
  629.           from 0 to 65 here.
  630.  
  631.           SmallCursor=0
  632.              Lecture uses a default cursor in its window (normally an
  633.           arrow).  This configuration item tells the program to use a tiny
  634.           "crosshair" cursor when you set this value to 1.  Note: the tiny
  635.           cursor only appears inside Lecture's display window -- it
  636.           switches back to a regular cursor when you move it to the
  637.           program's menu or to some other window.
  638.  
  639.           TotalPoints=7
  640.              Lecture allows up to seven points per slide by default, but
  641.           you can specify a new value from 1 to 32 here.
  642.  
  643.           Chapter 5, `Lecture file commands'                             13
  644.  
  645.  
  646.  
  647.  
  648.  
  649.                                       Chapter 5
  650.                                 Lecture file commands
  651.  
  652.           Lecture uses a traditional "script" language to assemble each
  653.           slide for a lecture.  You store commands in a standard text file
  654.           created by Microsoft's NotePad or any other program which can
  655.           edit ASCII files.
  656.  
  657.           (Caution: you can edit files with Microsoft's Write or Word for
  658.           Windows but you must not let them convert files to their own
  659.           format.)
  660.  
  661.  
  662.           5.1  Comments
  663.  
  664.           Lecture files may contain any number of blank lines or comments.
  665.           Comments begin with a semicolon ";" character.  You may also
  666.           optionally use Comment/Uncomment to enclose lines of comments,
  667.           but we don't recommend it.  (See the command summary for a full
  668.           explanation.)
  669.  
  670.  
  671.           5.2  Command lines
  672.  
  673.           Lecture files contain any number of command lines which direct
  674.           the program to perform a given task.  Each command appears on a
  675.           line of its own and starts with a keyword (see below).  Most
  676.           keywords take optional or required parameters; if so, they come
  677.           immediately after the keyword.  A space or tab character
  678.           separates the keyword from its parameter(s).
  679.  
  680.           Keywords may appear in uppercase, lowercase, or mixed case.
  681.           Example: "SHOWANDSAVE", "showandsave", and "ShowAndSave" all
  682.           reference the same command.
  683.  
  684.  
  685.           5.3  Command syntax
  686.  
  687.           5.3.1  ACCEPT
  688.  
  689.              Syntax      ACCEPT [AUTOSHOW] [BEEP] [COMMENT] [MESSAGE]
  690.  
  691.              Function    cancels a previous Ignore.  You can choose which
  692.                          commands the program should now accept.
  693.  
  694.              MinVersion  Lecture=100, Windows=300
  695.  
  696.              Example     Accept Comment Beep
  697.  
  698.              See also    AutoShow, Beep, Comment, Ignore, Message
  699.  
  700.              Comments    Lecture accepts all commands by default.
  701.  
  702.           14                                       Lecture v1.0 User Manual
  703.  
  704.  
  705.  
  706.           5.3.2  AUTOSHOW
  707.  
  708.              Syntax      AUTOSHOW delay
  709.  
  710.              Function    sets a default delay value (in seconds) for all
  711.                          commands which accept delay values.
  712.  
  713.              MinVersion  Lecture=100, Windows=300
  714.  
  715.              Example     AutoShow 5
  716.  
  717.              See also    Accept, Ignore, Show, ShowAndSave, Wait
  718.  
  719.              Comments    use a value of zero to disable a previous
  720.                          AutoShow.  The user can disable AutoShow via the
  721.                          menu.
  722.  
  723.           5.3.3  BEEP
  724.  
  725.              Syntax      BEEP [times]
  726.                          BEEP SHOW
  727.  
  728.              Function    syntax #1: issues a traditional "beep" command to
  729.                          Windows.  You can beep multiple times by supplying
  730.                          an optional value.  Syntax #2: causes the program
  731.                          to beep whenever it waits for the user to proceed
  732.                          to the next slide.  Specifically affects Show and
  733.                          ShowAndSave.
  734.  
  735.              MinVersion  Lecture=100, Windows=300
  736.  
  737.              Example     Beep 3
  738.                          Beep Show
  739.  
  740.              See also    Accept, AutoShow, Ignore, Message, Show
  741.  
  742.              Comments    syntax #1: optional value cannot exceed 255.
  743.                          Syntax #2: has no effect during an AutoShow, or if
  744.                          the affected commands specify an optional delay
  745.                          value, or if the user has disabled noises via a
  746.                          menu option.
  747.  
  748.           Chapter 5, `Lecture file commands'                             15
  749.  
  750.  
  751.  
  752.           5.3.4  COLORBACKGROUND
  753.  
  754.              Syntax      COLORBACKGROUND colorname
  755.                          COLORBACKGROUND redvalue,greenvalue,bluevalue
  756.  
  757.              Function    syntax #1: sets the window background to the named
  758.                          color (Black, Blue, Green, Red, White).  Syntax
  759.                          #2: sets the window background to the specified
  760.                          red/green/blue "electron gun" values.
  761.  
  762.              MinVersion  Lecture=100, Windows=300
  763.  
  764.              Example     ColorBackground White
  765.                          ColorBackground 255,255,255
  766.  
  767.              See also    ColorMasterTitle, ColorPoints, ColorSubTitle,
  768.                          ColorTitle
  769.  
  770.              Advice      use colors sparingly, preferably no more than
  771.                          three colors per slide.
  772.  
  773.              Comments    colors remain constant until changed.
  774.                          Specifically, ColorBackground uses the default
  775.                          background window color unless you override it
  776.                          with your own color.  Electron gun values range
  777.                          from 0 to 255 for each color.  Specific values for
  778.                          the named colors: Black (0,0,0), Blue (0,0,255),
  779.                          Green (0,255,0), Red (255,0,0), White
  780.                          (255,255,255).
  781.  
  782.           16                                       Lecture v1.0 User Manual
  783.  
  784.  
  785.  
  786.           5.3.5  COLORMASTERTITLE
  787.  
  788.              Syntax      COLORMASTERTITLE colorname
  789.                          COLORMASTERTITLE redvalue,greenvalue,bluevalue
  790.  
  791.              Function    syntax #1: sets the master title so it displays
  792.                          text in the named color (Black, Blue, Green, Red,
  793.                          White).  Syntax #2: sets the master title so it
  794.                          displays text according to the specified red/
  795.                          green/blue "electron gun" values.
  796.  
  797.              MinVersion  Lecture=100, Windows=300
  798.  
  799.              Example     ColorMasterTitle Blue
  800.                          ColorMasterTitle 0,0,255
  801.  
  802.              See also    ColorBackground, FontMasterTitle, MasterTitle
  803.  
  804.              Advice      use colors sparingly, preferably no more than
  805.                          three colors per slide.
  806.  
  807.              Comments    colors remain constant until changed.  Electron
  808.                          gun values range from 0 to 255 for each color.
  809.                          Specific values for the named colors: Black
  810.                          (0,0,0), Blue (0,0,255), Green (0,255,0), Red
  811.                          (255,0,0), White (255,255,255).
  812.  
  813.           5.3.6  COLORPOINT
  814.  
  815.              Syntax      COLORPOINT colorname
  816.                          COLORPOINT redvalue,greenvalue,bluevalue
  817.  
  818.              Function    syntax #1: sets the points so they display text in
  819.                          the named color (Black, Blue, Green, Red, White).
  820.                          Syntax #2: sets the points so they display text
  821.                          according to the specified red/green/blue
  822.                          "electron gun" values.
  823.  
  824.              MinVersion  Lecture=100, Windows=300
  825.  
  826.              Example     ColorPoint Black
  827.                          ColorPoint 0,0,0
  828.  
  829.              See also    ColorBackground, FontPoint, Point
  830.  
  831.              Advice      use colors sparingly, preferably no more than
  832.                          three colors per slide.
  833.  
  834.              Comments    colors remain constant until changed.  Electron
  835.                          gun values range from 0 to 255 for each color.
  836.                          Specific values for the named colors: Black
  837.                          (0,0,0), Blue (0,0,255), Green (0,255,0), Red
  838.                          (255,0,0), White (255,255,255).
  839.  
  840.           Chapter 5, `Lecture file commands'                             17
  841.  
  842.  
  843.  
  844.           5.3.7  COLORSUBTITLE
  845.  
  846.              Syntax      COLORSUBTITLE colorname
  847.                          COLORSUBTITLE redvalue,greenvalue,bluevalue
  848.  
  849.              Function    syntax #1: sets the subtitle so it displays text
  850.                          in the named color (Black, Blue, Green, Red,
  851.                          White).  Syntax #2: sets the subtitle so it
  852.                          displays text according to the specified red/
  853.                          green/blue "electron gun" values.
  854.  
  855.              MinVersion  Lecture=100, Windows=300
  856.  
  857.              Example     ColorSubTitle Red
  858.                          ColorSubTitle 255,0,0
  859.  
  860.              See also    ColorBackground, FontSubTitle, SubTitle
  861.  
  862.              Advice      use colors sparingly, preferably no more than
  863.                          three colors per slide.
  864.  
  865.              Comments    colors remain constant until changed.  Electron
  866.                          gun values range from 0 to 255 for each color.
  867.                          Specific values for the named colors: Black
  868.                          (0,0,0), Blue (0,0,255), Green (0,255,0), Red
  869.                          (255,0,0), White (255,255,255).
  870.  
  871.           5.3.8  COLORTITLE
  872.  
  873.              Syntax      COLORTITLE colorname
  874.                          COLORTITLE redvalue,greenvalue,bluevalue
  875.  
  876.              Function    syntax #1: sets the title so it displays text in
  877.                          the named color (Black, Blue, Green, Red, White).
  878.                          Syntax #2: sets the title so it displays text
  879.                          according to the specified red/green/blue
  880.                          "electron gun" values.
  881.  
  882.              MinVersion  Lecture=100, Windows=300
  883.  
  884.              Example     ColorTitle Red
  885.                          ColorTitle 255,0,0
  886.  
  887.              See also    ColorBackground, FontTitle, Title
  888.  
  889.              Advice      use colors sparingly, preferably no more than
  890.                          three colors per slide.
  891.  
  892.              Comments    colors remain constant until changed.  Electron
  893.                          gun values range from 0 to 255 for each color.
  894.                          Specific values for the named colors: Black
  895.                          (0,0,0), Blue (0,0,255), Green (0,255,0), Red
  896.                          (255,0,0), White (255,255,255).
  897.  
  898.           18                                       Lecture v1.0 User Manual
  899.  
  900.  
  901.  
  902.           5.3.9  COMMENT
  903.  
  904.              Syntax      COMMENT
  905.  
  906.              Function    treats every subsequent line of the file as a
  907.                          comment until you specify Uncomment.
  908.  
  909.              MinVersion  Lecture=100, Windows=300
  910.  
  911.              Example     Comment
  912.  
  913.              See also    Accept, Ignore, Uncomment
  914.  
  915.              Caution     use only while developing a lecture file.  Do not
  916.                          use this command to insert comments in the file --
  917.                          an Ignore Comment could wreak havoc with your
  918.                          file, especially if the user runs it via a RunFile
  919.                          command.  Instead, use a semicolon ";" character
  920.                          at the start of each comment line.
  921.  
  922.              Comments    Lecture displays a syntax error message if it
  923.                          reaches the end of a file before encountering an
  924.                          Uncomment.  Multiple Comment commands have no
  925.                          effect after the first one executes (unless you
  926.                          issue an Uncomment between them, of course).
  927.  
  928.           5.3.10  FONTMASTERTITLE
  929.  
  930.              Syntax      FONTMASTERTITLE fontname
  931.  
  932.              Function    sets the master title so it displays text in the
  933.                          named font.
  934.  
  935.              MinVersion  Lecture=100, Windows=300
  936.  
  937.              Example     FontMasterTitle Helvetica
  938.  
  939.              See also    ColorMasterTitle, MasterTitle
  940.  
  941.              Advice      use fonts sparingly, preferably no more than two
  942.                          fonts per slide.
  943.  
  944.              Comments    fonts remain constant until changed.  Windows will
  945.                          substitute a font if it can't find the named font.
  946.  
  947.           Chapter 5, `Lecture file commands'                             19
  948.  
  949.  
  950.  
  951.           5.3.11  FONTPOINT
  952.  
  953.              Syntax      FONTPOINT fontname
  954.  
  955.              Function    sets the points so they display text in the named
  956.                          font.
  957.  
  958.              MinVersion  Lecture=100, Windows=300
  959.  
  960.              Example     FontPoint Helvetica
  961.  
  962.              See also    ColorPoint, Point
  963.  
  964.              Advice      use fonts sparingly, preferably no more than two
  965.                          fonts per slide.
  966.  
  967.              Comments    fonts remain constant until changed.  Windows will
  968.                          substitute a font if it can't find the named font.
  969.  
  970.           5.3.12  FONTSUBTITLE
  971.  
  972.              Syntax      FONTSUBTITLE fontname
  973.  
  974.              Function    sets the subtitle so it displays text in the named
  975.                          font.
  976.  
  977.              MinVersion  Lecture=100, Windows=300
  978.  
  979.              Example     FontSubTitle Helvetica
  980.  
  981.              See also    ColorSubTitle, SubTitle
  982.  
  983.              Advice      use fonts sparingly, preferably no more than two
  984.                          fonts per slide.
  985.  
  986.              Comments    fonts remain constant until changed.  Windows will
  987.                          substitute a font if it can't find the named font.
  988.  
  989.           20                                       Lecture v1.0 User Manual
  990.  
  991.  
  992.  
  993.           5.3.13  FONTTITLE
  994.  
  995.              Syntax      FONTTITLE fontname
  996.  
  997.              Function    sets the title so it displays text in the named
  998.                          font.
  999.  
  1000.              MinVersion  Lecture=100, Windows=300
  1001.  
  1002.              Example     FontTitle Helvetica
  1003.  
  1004.              See also    ColorTitle, Title
  1005.  
  1006.              Advice      use fonts sparingly, preferably no more than two
  1007.                          fonts per slide.
  1008.  
  1009.              Comments    fonts remain constant until changed.  Windows will
  1010.                          substitute a font if it can't find the named font.
  1011.  
  1012.           5.3.14  ICONIZE
  1013.  
  1014.              Syntax      ICONIZE
  1015.  
  1016.              Function    forces the Lecture window down to an icon.
  1017.  
  1018.              MinVersion  Lecture=100, Windows=300
  1019.  
  1020.              Example     Iconize
  1021.  
  1022.              See also    Uniconize, Unzoom, Zoom
  1023.  
  1024.              Comments    has no effect on an already-iconized window.
  1025.  
  1026.           5.3.15  IGNORE
  1027.  
  1028.              Syntax      IGNORE [AUTOSHOW] [BEEP] [COMMENT] [MESSAGE]
  1029.  
  1030.              Function    tells the program to ignore AutoShow, Beep,
  1031.                          Comment, and/or Message.  You can choose which
  1032.                          commands to ignore and list them in any order on
  1033.                          this command line.
  1034.  
  1035.              MinVersion  Lecture=100, Windows=300
  1036.  
  1037.              Example     Ignore Message AutoShow Beep
  1038.  
  1039.              See also    Accept, AutoShow, Beep, Comment, Message
  1040.  
  1041.              Comments    you may repeat an Ignore without worry.
  1042.  
  1043.           Chapter 5, `Lecture file commands'                             21
  1044.  
  1045.  
  1046.  
  1047.           5.3.16  MASTERTITLE
  1048.  
  1049.              Syntax      MASTERTITLE [text]
  1050.  
  1051.              Function    initializes the upper-right-corner text of each
  1052.                          slide to display the associated text.
  1053.  
  1054.              MinVersion  Lecture=100, Windows=300
  1055.  
  1056.              Example     MasterTitle Calculus 402 (Mr. Rosenberger)
  1057.  
  1058.              See also    ColorMasterTitle, FontMasterTitle, Point, Show,
  1059.                          ShowAndSave, SubPoint, SubTitle, Title
  1060.  
  1061.              Comments    the master title text remains constant until
  1062.                          changed.
  1063.  
  1064.           5.3.17  MESSAGE
  1065.  
  1066.              Syntax      MESSAGE text
  1067.  
  1068.              Function    displays a message with the specified text and
  1069.                          waits for the user to acknowledge it.
  1070.  
  1071.              MinVersion  Lecture=100, Windows=300
  1072.  
  1073.              Example     Message Copyright 1992 by Barn Owl Software; all
  1074.                          rights reserved.
  1075.  
  1076.              See also    Beep, MessageTitle, Show, Wait
  1077.  
  1078.              Comments    you may want to use Wait to create a slight delay
  1079.                          between the time a slide appears versus when the
  1080.                          message appears.  Lecture displays a syntax error
  1081.                          message if you don't specify any text.
  1082.  
  1083.           5.3.18  MESSAGETITLE
  1084.  
  1085.              Syntax      MESSAGETITLE text
  1086.  
  1087.              Function    sets the window title for future Message commands.
  1088.  
  1089.              MinVersion  Lecture=100, Windows=300
  1090.  
  1091.              Example     MessageTitle Copyright notice
  1092.  
  1093.              See also    Message
  1094.  
  1095.              Comments    the message window title remains constant until
  1096.                          changed.  The program initializes the title to
  1097.                          "Lecture Message" at startup.
  1098.  
  1099.           22                                       Lecture v1.0 User Manual
  1100.  
  1101.  
  1102.  
  1103.           5.3.19  MINVERSION
  1104.  
  1105.              Syntax      MINVERSION [WINDOWS] [version number * 100]
  1106.  
  1107.              Function    lets Lecture know if it can process all the
  1108.                          commands in a file.  It displays a warning message
  1109.                          if it detects a value higher than its own version
  1110.                          number (multiplied by 100), or a value higher
  1111.                          higher than the Windows version number (multiplied
  1112.                          by 100).
  1113.  
  1114.              Example     MinVersion 104
  1115.                          MinVersion Windows 310
  1116.  
  1117.              Caution     use only once, at the top of the file, with a
  1118.                          value based on the highest "MinVersion" number
  1119.                          specified for commands used in the file.  Multiple
  1120.                          identical MinVersion commands may generate
  1121.                          redundant warning messages, annoying the user.
  1122.  
  1123.              Comments    future versions of Lecture will almost certainly
  1124.                          offer new commands, some of them possibly based on
  1125.                          the capabilities of a specific Windows version.
  1126.                          This provides a way for future lecture files to
  1127.                          warn older program versions, or a current Lecture
  1128.                          program running in an older version of Windows.
  1129.  
  1130.           5.3.20  POINT
  1131.  
  1132.              Syntax      POINT [text]
  1133.  
  1134.              Function    sets the (first or) next presentation point of an
  1135.                          upcoming slide to a given line of text.
  1136.  
  1137.              MinVersion  Lecture=100, Windows=300
  1138.  
  1139.              Example     Point Isaac Newton wasn't the only one
  1140.  
  1141.              See also    ColorPoint, FontPoint, MasterTitle, Point,
  1142.                          SamePoint, Show, ShowAndSave, SubPoint,
  1143.                          SubSubPoint, SubSubSubPoint, SubTitle, Title
  1144.  
  1145.              Comments    Lecture increments an internal counter after each
  1146.                          Point/SubPoint so you don't have to use numerous
  1147.                          different commands.  Use Point with no text to
  1148.                          leave a blank line between other points on the
  1149.                          slide.  Points reinitialize after every Show; use
  1150.                          ShowAndSave if you want to keep the text on hand
  1151.                          for another slide show display.
  1152.  
  1153.           Chapter 5, `Lecture file commands'                             23
  1154.  
  1155.  
  1156.  
  1157.           5.3.21  RUNFILE
  1158.  
  1159.              Syntax      RUNFILE filename
  1160.  
  1161.              Function    suspends processing of the current file and begins
  1162.                          processing the named file.  When finished, the
  1163.                          program will continue processing the original
  1164.                          file.
  1165.  
  1166.              MinVersion  Lecture=100, Windows=300
  1167.  
  1168.              Example     RunFile NEWS-RLS.LEC
  1169.  
  1170.              See also    AutoShow
  1171.  
  1172.              Comments    you can process a file containing a RunFile of its
  1173.                          own, up to a total "nested level" of four files.
  1174.                          Lecture displays a syntax error message if you
  1175.                          nest too many of these commands.
  1176.  
  1177.           5.3.22  SAMEPOINT
  1178.  
  1179.              Syntax      SAMEPOINT [text]
  1180.  
  1181.              Function    identical to Point, but it overwrites the text of
  1182.                          the (only or) last Point.
  1183.  
  1184.              MinVersion  Lecture=100, Windows=300
  1185.  
  1186.              Example     SamePoint Isaac Newton wasn't the only one
  1187.  
  1188.              See also    ColorPoint, FontPoint, Point, ShowAndSave
  1189.  
  1190.              Advice      use with ShowAndSave to "animate" a slide.
  1191.  
  1192.              Comments    does not affect Lecture's internal counter
  1193.                          (normally incremented for each Point/SubPoint).
  1194.                          Points reinitialize after each Show, so use
  1195.                          ShowAndSave to keep the text on hand for another
  1196.                          slide show display.  SamePoint does not have a
  1197.                          corresponding "SameSubPoint" command.
  1198.  
  1199.           24                                       Lecture v1.0 User Manual
  1200.  
  1201.  
  1202.  
  1203.           5.3.23  SHOW
  1204.  
  1205.              Syntax      SHOW [delay]
  1206.  
  1207.              Function    displays the currently assembled slide and stops
  1208.                          processing until the user wants to go to the next
  1209.                          slide.  Or you can include a delay value (in
  1210.                          seconds) to automatically continue processing the
  1211.                          file after showing the slide.
  1212.  
  1213.              MinVersion  Lecture=100, Windows=300
  1214.  
  1215.              Example     Show 5
  1216.  
  1217.              See also    AutoShow, Message, ShowAndSave, Wait
  1218.  
  1219.              Comments    clears the values of any previous SubTitle or
  1220.                          Point; in other words, the second of two Show
  1221.                          commands in a row would display only a MasterTitle
  1222.                          and Title.  Users can bypass the optional delay
  1223.                          value by choosing to go on to the next slide.
  1224.  
  1225.           5.3.24  SHOWANDSAVE
  1226.  
  1227.              Syntax      SHOWANDSAVE [delay]
  1228.  
  1229.              Function    identical to Show, but it doesn't clear the text
  1230.                          of any previous SubTitle or Point.
  1231.  
  1232.              MinVersion  Lecture=100, Windows=300
  1233.  
  1234.              Example     ShowAndSave 2
  1235.  
  1236.              See also    AutoShow, Show, Wait
  1237.  
  1238.              Comments    often used to "animate" a slide, displaying one
  1239.                          point at a time in a delayed fashion.
  1240.  
  1241.           5.3.25  SUBPOINT
  1242.  
  1243.              Syntax      SUBPOINT [text]
  1244.  
  1245.              Function    identical to Point, but it indents the text.
  1246.  
  1247.              MinVersion  Lecture=100, Windows=300
  1248.  
  1249.              Example     SubPoint Isaac Newton wasn't the only one
  1250.  
  1251.              See also    ColorPoint, FontPoint, Point, SubSubPoint
  1252.  
  1253.              Advice      use after a Point.
  1254.  
  1255.              Comments    see Point.
  1256.  
  1257.           Chapter 5, `Lecture file commands'                             25
  1258.  
  1259.  
  1260.  
  1261.           5.3.26  SUBSUBPOINT
  1262.  
  1263.              Syntax      SUBSUBPOINT [text]
  1264.  
  1265.              Function    identical to SubPoint, but it indents the text.
  1266.  
  1267.              MinVersion  Lecture=100, Windows=300
  1268.  
  1269.              Example     SubSubPoint Isaac Newton wasn't the only one
  1270.  
  1271.              See also    ColorPoint, FontPoint, Point, SubPoint,
  1272.                          SubSubSubPoint
  1273.  
  1274.              Advice      use after a SubPoint.
  1275.  
  1276.              Comments    see Point.
  1277.  
  1278.           5.3.27  SUBSUBSUBPOINT
  1279.  
  1280.              Syntax      SUBSUBSUBPOINT [text]
  1281.  
  1282.              Function    identical to SubSubPoint, but it indents the text.
  1283.  
  1284.              MinVersion  Lecture=100, Windows=300
  1285.  
  1286.              Example     SubSubSubPoint Isaac Newton wasn't the only one
  1287.  
  1288.              See also    ColorPoint, FontPoint, Point, SubSubPoint
  1289.  
  1290.              Advice      use after a SubSubPoint.
  1291.  
  1292.              Comments    see Point.
  1293.  
  1294.           5.3.28  SUBTITLE
  1295.  
  1296.              Syntax      SUBTITLE [text]
  1297.  
  1298.              Function    sets the subtitle of the upcoming slide to a given
  1299.                          value.
  1300.  
  1301.              MinVersion  Lecture=100, Windows=300
  1302.  
  1303.              Example     SubTitle Safely dividing by zero
  1304.  
  1305.              See also    ColorSubTitle, FontSubTitle, MasterTitle, Title,
  1306.                          Point, Show, ShowAndSave, SubPoint
  1307.  
  1308.              Comments    the SubTitle text reinitializes after every Show.
  1309.                          Use ShowAndSave if you want to keep the text on
  1310.                          hand for another slide display.
  1311.  
  1312.           26                                       Lecture v1.0 User Manual
  1313.  
  1314.  
  1315.  
  1316.           5.3.29  TITLE
  1317.  
  1318.              Syntax      TITLE [text]
  1319.  
  1320.              Function    sets the text for future slide titles.
  1321.  
  1322.              MinVersion  Lecture=100, Windows=300
  1323.  
  1324.              Example     Title The Need for Calculus
  1325.  
  1326.              See also    ColorTitle, FontTitle, MasterTitle, SubTitle,
  1327.                          Point, Show, ShowAndSave, SubPoint
  1328.  
  1329.              Comments    the title text remains constant until changed.
  1330.  
  1331.           5.3.30  TOTALPOINTS
  1332.  
  1333.              Syntax      TOTALPOINTS value
  1334.  
  1335.              Function    specifies the maximum number of points/subpoints
  1336.                          allowed on a single slide.
  1337.  
  1338.              MinVersion  Lecture=100, Windows=300
  1339.  
  1340.              Example     TotalPoints 10
  1341.  
  1342.              See also    Point, SubPoint
  1343.  
  1344.              Caution     use only once, at the top of the file.  Changing
  1345.                          it "on the fly" during a presentation will make
  1346.                          the program resize text so everything fits in the
  1347.                          window (based on its visible height).
  1348.  
  1349.              Comments    defaults to a maximum of seven points/subpoints
  1350.                          per slide.  The specified value must fall in the
  1351.                          range of 1..32, else Lecture will display a syntax
  1352.                          error message.
  1353.  
  1354.           Chapter 5, `Lecture file commands'                             27
  1355.  
  1356.  
  1357.  
  1358.           5.3.31  UNCOMMENT
  1359.  
  1360.              Syntax      UNCOMMENT
  1361.  
  1362.              Function    negates a Comment.  File processing continues
  1363.                          normally.
  1364.  
  1365.              MinVersion  Lecture=100, Windows=300
  1366.  
  1367.              Example     Uncomment
  1368.  
  1369.              See also    Accept, Ignore, Comment
  1370.  
  1371.              Caution     use only while developing a lecture file.  Do not
  1372.                          use this command to insert comments in the file --
  1373.                          an Ignore Comment could wreak havoc with your
  1374.                          file, especially if the user runs it via a RunFile
  1375.                          command.  Instead, use a semicolon ";" character
  1376.                          at the start of each comment line.
  1377.  
  1378.              Comments    Lecture displays a syntax error message if it
  1379.                          reaches the end of a file before encountering an
  1380.                          Uncomment.  Multiple Uncomment commands have no
  1381.                          effect after the first one executes (unless you
  1382.                          issue a Comment between them, of course).
  1383.  
  1384.           5.3.32  UNICONIZE
  1385.  
  1386.              Syntax      UNICONIZE
  1387.  
  1388.              Function    forces the Lecture window to its "normal" window
  1389.                          dimensions.
  1390.  
  1391.              MinVersion  Lecture=100, Windows=300
  1392.  
  1393.              Example     Uniconize
  1394.  
  1395.              See also    Iconize, Unzoom, Zoom
  1396.  
  1397.              Comments    has no effect on an already-normal-size screen.
  1398.                          Unzoom performs the same function.
  1399.  
  1400.           28                                       Lecture v1.0 User Manual
  1401.  
  1402.  
  1403.  
  1404.           5.3.33  UNZOOM
  1405.  
  1406.              Syntax      UNZOOM
  1407.  
  1408.              Function    forces the Lecture window to its "normal" window
  1409.                          dimensions.
  1410.  
  1411.              MinVersion  Lecture=100, Windows=300
  1412.  
  1413.              Example     Unzoom
  1414.  
  1415.              See also    Iconize, Uniconize, Zoom
  1416.  
  1417.              Comments    has no effect on an already-normal-size screen.
  1418.                          Uniconize performs the same function.
  1419.  
  1420.           5.3.34  WAIT
  1421.  
  1422.              Syntax      WAIT delay
  1423.  
  1424.              Function    stops processing for the specified number of
  1425.                          seconds.
  1426.  
  1427.              MinVersion  Lecture=100, Windows=300
  1428.  
  1429.              Example     Wait 5
  1430.  
  1431.              See also    AutoShow, Show, ShowAndSave
  1432.  
  1433.              Comments    users can bypass the optional delay value by
  1434.                          choosing to go on to the next slide.
  1435.  
  1436.           5.3.35  ZOOM
  1437.  
  1438.              Syntax      ZOOM
  1439.  
  1440.              Function    forces the Lecture window to occupy the full
  1441.                          screen.
  1442.  
  1443.              MinVersion  Lecture=100, Windows=300
  1444.  
  1445.              Example     Zoom
  1446.  
  1447.              See also    Iconize, Uniconize, Unzoom
  1448.  
  1449.              Comments    has no effect on an already-zoomed window.
  1450.  
  1451.                                                                          29
  1452.  
  1453.  
  1454.  
  1455.  
  1456.  
  1457.  
  1458.  
  1459.  
  1460.  
  1461.  
  1462.  
  1463.  
  1464.  
  1465.  
  1466.  
  1467.  
  1468.  
  1469.  
  1470.  
  1471.                                         PART 3
  1472.                                      Appendixes
  1473.  
  1474.           30                                       Lecture v1.0 User Manual
  1475.  
  1476.  
  1477.  
  1478.  
  1479.  
  1480.                                       Appendix A
  1481.                                Status & error messages
  1482.  
  1483.           Couldn't locate the specified lecture file.
  1484.              * The filename listed with the Lecture command line doesn't
  1485.                exist.
  1486.              * A RunFile command specified a bad filename.
  1487.  
  1488.           Couldn't open the specified lecture file.
  1489.              * You specified a file containing binary data rather than
  1490.                ASCII text.  (Often occurs if you save a file in Write,
  1491.                Word, or WordPerfect format.)
  1492.              * You specified a file containing zero bytes.
  1493.  
  1494.           Incorrect syntax.  Continue?
  1495.              * You specified a lecture file command with incorrect,
  1496.                missing, or excess parameters.  Read about the command in
  1497.                question to determine the cause of the problem.
  1498.  
  1499.           End of file reached with no Uncomment command.  Continue?
  1500.              * A Comment command appears somewhere in the lecture file with
  1501.                no corresponding Uncomment command.
  1502.  
  1503.           Runtime error nnnn at xxxx:yyyy
  1504.              * This "catch-all" error message means Lecture encountered a
  1505.                problem it couldn't handle.  Please tell Barn Owl Software
  1506.                if you get this message and give a detailed description of
  1507.                what you did.
  1508.  
  1509.           Specified value out of range.  Continue?
  1510.              * The lecture file command in question takes a numeric value
  1511.                only within a specified range.  Read about the command to
  1512.                determine the cause of the problem.
  1513.  
  1514.           This file uses capabilities of a later version of Lecture and
  1515.           will not operate as expected under this version of the program.
  1516.           Continue anyway?
  1517.              * The current lecture file contains a MinVersion command which
  1518.                claims it uses commands allowed under a newer version of
  1519.                Lecture.  The lecture file will probably not operate as
  1520.                expected, but you can choose whether or not to process the
  1521.                file anyway.  Note: a syntax message will pop up whenever
  1522.                the program encounters a command it can't handle.  You
  1523.                cannot turn off syntax error messages via the "Options/
  1524.                Messages allowed" menu item.
  1525.  
  1526.           This file uses capabilities of a later version of Windows and
  1527.           will not operate as expected under this version of Windows.
  1528.           Continue anyway?
  1529.              * The current lecture file contains a MinVersion command which
  1530.                claims it uses commands designed for a newer version of
  1531.                Microsoft Windows.  The lecture file will probably not
  1532.  
  1533.           Appendix A, `Status & error messages'                          31
  1534.  
  1535.  
  1536.  
  1537.                operate as expected, but you can choose whether or not to
  1538.                process the file anyway.  Note: a syntax message will pop up
  1539.                whenever the program encounters a command it can't handle.
  1540.                You cannot turn off syntax error messages via the "Options/
  1541.                Messages allowed" menu item.
  1542.  
  1543.           Too many points/subpoints specified for one slide.  Continue?
  1544.              * You failed to specify a Show command.  Lecture continued to
  1545.                assemble a slide using points for the next slide, and it
  1546.                eventually exceeded the total number of points allowed.
  1547.              * You didn't specify a correct TotalPoints value for the slide
  1548.                in question.
  1549.              * You previously used a TotalPoints command and failed to
  1550.                reset the value for this slide.
  1551.  
  1552.           Unknown command.  Continue?
  1553.              * You failed to use a semicolon as the first character of a
  1554.                comment line.
  1555.              * You enclosed comments with a Comment command, but a previous
  1556.                Ignore Comments command has canceled its effect.
  1557.              * You have an older version of Lecture and decided to run a
  1558.                lecture file with commands recognized by a newer version of
  1559.                the program.
  1560.  
  1561.           Windows couldn't allocate enough resources to perform this
  1562.           function!
  1563.              * Windows didn't have enough memory, file handles, etc.
  1564.                available for the program to execute a given function.
  1565.                Close other windows to free up needed resources.
  1566.  
  1567.           32                                       Lecture v1.0 User Manual
  1568.  
  1569.  
  1570.  
  1571.  
  1572.  
  1573.                                       Appendix B
  1574.                                     Helpful hints
  1575.  
  1576.  
  1577.           B.1  Invoking Lecture
  1578.  
  1579.           LECTURE
  1580.              Windows loads the program into memory with no special
  1581.              instructions.
  1582.  
  1583.           LECTURE  MYTALK.LEC
  1584.              Windows loads the program into memory; it then immediately
  1585.              begins processing the MYTALK.LEC file.
  1586.  
  1587.  
  1588.           B.2  Common questions & answers
  1589.  
  1590.           "I just need to present a quick lecture.  What commands do I
  1591.           absolutely have to know about to get started?"
  1592.              You need to learn six commands: MasterTitle, Title, SubTitle,
  1593.           Point, SubPoint, and Show.
  1594.  
  1595.           "The Lecture window sometimes zooms in/out of full-screen status
  1596.           or pops back up after I iconize it.  How come?"
  1597.              Lecture files can issue commands affecting the state of
  1598.           Lecture's window.  Specifically, the lecture file contains one of
  1599.           the following commands: Zoom, Unzoom, Iconize, or Uniconize.
  1600.  
  1601.           "Can I edit lecture files with another program besides NotePad?"
  1602.              Certainly -- but remember, many word processors use their own
  1603.           proprietary file format by default.  Please make sure the program
  1604.           you choose saves your file in ASCII format.
  1605.  
  1606.           Appendix C, `Troubleshooting a lecture file'                   33
  1607.  
  1608.  
  1609.  
  1610.  
  1611.  
  1612.                                       Appendix C
  1613.                            Troubleshooting a lecture file
  1614.  
  1615.           We at Barn Owl Software build lecture files "on the fly" by
  1616.           resizing Lecture and Microsoft's NotePad as small windows.  We
  1617.           assemble three or four slides in a file, save it, and run it
  1618.           under Lecture to see how it looks.  If all goes well, we "comment
  1619.           out" those slides with the Comment/Uncomment commands and
  1620.           assemble another few slides.  The process continues until we
  1621.           finish a lecture, at which point we remove all the Comment/
  1622.           Uncomment commands.  Naturally, we check the final result one
  1623.           last time just to make sure it runs correctly.
  1624.  
  1625.           In many cases where a lecture file doesn't display slides as it
  1626.           should, you may simply have forgotten a Show command.  Lecture
  1627.           will continue to assemble a slide based on commands for the next
  1628.           slide, possibly displaying a syntax error message in the process.
  1629.  
  1630.           34                                       Lecture v1.0 User Manual
  1631.  
  1632.  
  1633.  
  1634.  
  1635.  
  1636.  
  1637.  
  1638.                                         Index
  1639.  
  1640.               A                              L
  1641.               ACCEPT command 13              Lecture
  1642.               AUTOSHOW command 10, 13,         limited license 3
  1643.                 14, 20                         support 4
  1644.                                              legal notices 1
  1645.               B                              license See: registration
  1646.               Barn Owl address 1
  1647.               BEEP command 13, 14, 20        M
  1648.               BLACK color command 15,        MASTERTITLE command 7, 21,
  1649.                 16, 17                         24
  1650.               BLUE color command 15, 16,     MESSAGE command 11, 13,
  1651.                 17                             20, 21
  1652.                                              MESSAGETITLE command 21
  1653.               C                              MINVERSION command 22
  1654.               cautions 13, 18, 22, 26,
  1655.                 27, See Also: warnings       N
  1656.               COLORBACKGROUND command 15     notes 8, 11, 12, 30, 31,
  1657.               COLORMASTERTITLE command         See Also: cautions
  1658.                 15
  1659.               COLORPOINT command 16          P
  1660.               COLORSUBTITLE command 17       POINT command 7, 22, 23,
  1661.               COLORTITLE command 17            24, 25
  1662.               COMMENT command 13, 18,
  1663.                 20, 27                       R
  1664.                                              RED color command 15, 16,
  1665.               D                                17
  1666.               disk vendors 3                 registration 4
  1667.               distributors See: disk           site 4
  1668.                 vendors                        volume discounts 4
  1669.                                              RUNFILE command 18, 23, 27
  1670.               F
  1671.               files 8                        S
  1672.               FONTMASTERTITLE command 18     SAMEPOINT command 23
  1673.               FONTPOINT command 19           shareware 1, 2
  1674.               FONTSUBTITLE command 19        SHOW command 7, 14, 22,
  1675.               FONTTITLE command 20             23, 24, 25
  1676.                                              SHOWANDSAVE command 14,
  1677.               G                                22, 23, 24, 25
  1678.               GREEN color command 15,        SUBPOINT command 7, 24, 25
  1679.                 16, 17                       SUBSUBPOINT command 25
  1680.                                              SUBSUBSUBPOINT command 25
  1681.               H                              SUBTITLE command 7, 24, 25
  1682.               hints 32
  1683.                                              T
  1684.               I                              TITLE command 7, 24, 26
  1685.               ICONIZE command 20             TOTALPOINTS command 12, 26
  1686.               IGNORE command 13, 18, 20,     trademarks 1
  1687.                 27
  1688.  
  1689.           Index                                                          35
  1690.  
  1691.  
  1692.  
  1693.               U                              W
  1694.               UNCOMMENT command 13, 18,      WAIT command 21, 28
  1695.                 27                           warnings See Also: notes
  1696.               UNICONIZE command 27, 28       warranty 2
  1697.               UNZOOM command 27, 28          WHITE color command 15,
  1698.                                                16, 17
  1699.               V
  1700.               visual aids 32                 Z
  1701.                                              ZOOM command 28
  1702.